home *** CD-ROM | disk | FTP | other *** search
/ Nebula 1 / Nebula One.iso / Mail / pine3.92 / contrib / carmel / doc / carmel-driver next >
Text File  |  1993-09-20  |  6KB  |  158 lines
  1.  
  2.  
  3. Carmel driver notes
  4. -------------------
  5. Set folder-collections=#carmel#[] to configure Pine to use the
  6. carmel driver. You may include other colllections like a directory full
  7. of Berkeley mail folder
  8.  
  9.  
  10.  
  11. Be sure you don't have a file called ".mailboxlist" in your home
  12. directory. If you do the list of mailboxes presented to be by
  13. the c-client will be out of that file rather than by querying each
  14. driver.
  15.  
  16. If you have files in your home or mail directory, be sure they aren't
  17. called anything that starts with "#carmel#" or %carmel%. They will be
  18. incorrectly included by mail_find for the bezerk and other drivers.
  19.  
  20. The carmel driver doesn't grab "inbox". This is to allow other drivers
  21. a shot at it. This may or may not work out in the long run.  With the
  22. current version of Pine you must set your inbox-path=#carmel#inbox to
  23. cause the carmel inbox to be used.
  24.  
  25.  
  26. Patching/Compilation for Pine
  27. -----------------------------
  28.  
  29. This set of files and patches was created for Pine 3.85 and the
  30. corresponding version 3.0 of the c-client and 7.63 of imapd. Hopefully
  31. they will continue to work with future versions of all of these. To
  32. apply the patches copy all the files in the subdirectories here (pine,
  33. c-client and imapd) to the corresponding directories in the Pine
  34. source. The run patch on each of the patch files and finally run the
  35. build script in Pine source root directory. This should result in a
  36. pine, pico and imapd binary in the bin directory ready to be
  37. installed. In the c-client directory there will be a bzk2cml binary
  38. for converting a Berkeley format mailbox to a Carmel format mailbox
  39. for the user running the program.
  40.  
  41. The modifications to the Pine source are minimal. The two parts are
  42. the calls to link in the carmel driver, and the patches to display
  43. BWC-GLYPH text. Nearly all the patches are for the later. One
  44. additional patch is needed to specify the right driver for creating
  45. new mailboxes. This is currently a bit of a hack in Pine and will
  46. hopefully be fixed future versions of Pine. The patches to imapd are
  47. of exactly the same nature as those to Pine.
  48.  
  49. If some of these patches fail, it's probably due to changes made in
  50. Pine (applying them to some other version than 3.85).  In that cases
  51. the patches will have to be made manually. 
  52.  
  53.  
  54.    
  55. Fixed since the version of Sept '92.
  56. ------------------------------------
  57. * Updated to conform with the changes in UW internal changes from
  58.   version 3.5X to 3.84. With these changes all the internal Pine calls
  59.   to the c-client are stabilized, possibly except some changes for
  60.   mail_create. This makes the carmel driver trivial to integrate with
  61.   future versions of Pine.
  62.  
  63. * Driver now checkpoints both carmel and carmel2 indexes. This should
  64.   save the nightly from deleting mail that it shouldn't.
  65.  
  66. * The driver only defaults messages without any content-type to
  67.   X-bwc-glyph instead of messages that were tagged text/plain. This will
  68.   cause the the glyph to richtext translations not to be applied when
  69.   the message already has a MIME header.
  70.  
  71. * Some bug fixes to display of BWC-GLYPH text, including bug causing
  72.   periodic core dumps. 
  73.  
  74. * Handles case where data file for a message is missing properly
  75.  
  76. * Bug fixes so critical code in driver is properly protected from
  77.   signals and interrupts.
  78.  
  79. * Bzk2cml utility included to convert Berkeley mail folder into carmel
  80.   folders. 
  81.  
  82. * Fixed bug causing text of currently viewed message to be redisplayed
  83.   incorrectly after the arrival of new mail.
  84.  
  85. * Carmel text served up by imapd is tagged type "plain" instead of
  86.   "X-bwc-glyph", though the text is not yet converted to richtext
  87.   and quoted-printable encoded like it should be to work with other
  88.   clients. 
  89.  
  90.  
  91. Fixed in the Aug 1 version
  92. --------------------------
  93. * Only creates a maximum of four Carmel index backup files (COD.FUR files)
  94.  
  95. * Folder listing now works with standard IMAP patterns
  96.   
  97. * Carmel index is check-pointed on expunges
  98.  
  99. * Carmel driver checks for new mail with folder name #carmel#inbox
  100.  
  101. * New mail is incorporated on other than inbox
  102.  
  103. * MIME decoding works properly now
  104.  
  105. * Safer incorporation of new mail from /usr/spool/mail (carmel2 writes flushed)
  106.  
  107.  
  108. Fixed in Aug 23 version
  109. -----------------------
  110.  
  111. * Fetchheader includes the separator so append will work
  112.  
  113. * Fixed append to get size right and not insert random NULL's, \n's...
  114.  
  115. * Conversion of glyph format to rich text in imapd
  116.  
  117.  
  118. Fixed in Aug 29 version
  119. -----------------------
  120. * Further fixes to append, including full locking
  121.  
  122. * The #carmel#user#folder syntax now works properly
  123.  
  124. * Further fixes to imapd to convert to richtext only when appropriate
  125.  
  126.  
  127. Fixed in Sep 2 version
  128. ----------------------
  129. * Nearly complete conversion from glyph to richtext
  130.  
  131. * Fixed bug causing lost new mail on quick in/out Pine sessions
  132.  
  133. * A few related Pine bugs fixed: sorting, wrapping
  134.   
  135.  
  136. Fixed in Sep 25 version
  137. -----------------------
  138.  
  139. * Recognizes all messages with subtype beginning with x-bwc-glyph as Glyph text. 
  140. * Saves messages of type x-bwc-glyph-wide in files ending with .wid
  141.  
  142. * When saving messages, the link is used rather than making a new file
  143.  
  144. * Glyph messages after 1994 must have the x-bwc-glyph tag to be recognized
  145.  
  146. * Bug fix to properly display '@' in glyph text
  147.  
  148. * Incorporation of latest version of c-client (minor bug fixes)
  149.  
  150.  
  151.  
  152. General Features
  153. ----------------
  154. * The driver checks the MAIL environment variable for the place to
  155. look for new incoming mail for the "inbox".
  156.  
  157. (There's a lot more than this, but it's not documented yet)
  158.